package com.campus.food.service;

import com.campus.food.model.entity.User;
import com.campus.food.model.dto.LoginDTO;
import com.campus.food.model.dto.RegisterDTO;

import java.util.List;

/**
 * 用户服务接口
 * 
 * @author Claude3.7 Sonnet
 * @since 2025-05-29
 */
public interface UserService {
    
    /**
     * 用户注册
     * @param registerDTO 注册信息
     * @return 注册成功的用户信息
     */
    User register(RegisterDTO registerDTO);
    
    /**
     * 用户登录
     * @param loginDTO 登录信息
     * @return JWT令牌
     */
    String login(LoginDTO loginDTO);
    
    /**
     * 根据ID查询用户
     * @param id 用户ID
     * @return 用户信息
     */
    User getUserById(Long id);
    
    /**
     * 根据用户名查询用户
     * @param username 用户名
     * @return 用户信息
     */
    User getUserByUsername(String username);
    
    /**
     * 更新用户信息
     * @param user 用户信息
     * @return 更新结果
     */
    boolean updateUser(User user);
    
    /**
     * 更新用户状态
     * @param id 用户ID
     * @param status 状态
     * @return 更新结果
     */
    boolean updateUserStatus(Long id, Integer status);
    
    /**
     * 分页查询用户列表
     * @param page 页码
     * @param size 每页大小
     * @param username 用户名（可选）
     * @param realName 真实姓名（可选）
     * @param role 角色（可选）
     * @param status 状态（可选）
     * @return 用户列表
     */
    List<User> getUserList(int page, int size, String username, String realName, Integer role, Integer status);
    
    /**
     * 查询用户总数
     * @param username 用户名（可选）
     * @param realName 真实姓名（可选）
     * @param role 角色（可选）
     * @param status 状态（可选）
     * @return 用户总数
     */
    long getUserCount(String username, String realName, Integer role, Integer status);
    
    /**
     * 根据角色查询用户列表
     * @param role 角色
     * @return 用户列表
     */
    List<User> getUsersByRole(Integer role);
    
    /**
     * 检查用户名是否存在
     * @param username 用户名
     * @return 是否存在
     */
    boolean existsByUsername(String username);
    
    /**
     * 检查手机号是否存在
     * @param phone 手机号
     * @return 是否存在
     */
    boolean existsByPhone(String phone);
    
    /**
     * 检查邮箱是否存在
     * @param email 邮箱
     * @return 是否存在
     */
    boolean existsByEmail(String email);
    
    /**
     * 删除用户
     * @param id 用户ID
     * @return 删除结果
     */
    boolean deleteUser(Long id);
    
    /**
     * 更新最后登录时间
     * @param id 用户ID
     * @return 更新结果
     */
    boolean updateLastLoginTime(Long id);
    
    /**
     * 修改密码
     * @param userId 用户ID
     * @param oldPassword 原密码
     * @param newPassword 新密码
     * @return 修改结果
     */
    boolean changePassword(Long userId, String oldPassword, String newPassword);
} 